home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / ava40.zip / AVACFG.DOC < prev    next >
Text File  |  1991-02-14  |  15KB  |  514 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                 **  #  # ###  ##  #     #  ##  ### ###  ###
  16.                *  * #  #  #  #  # ##   ## #  #  #  #    #  #
  17.                **** #  #  #  #  # # # # # ####  #  ##   #  #
  18.                *  *  ##   #   ##  #  #  # #  #  #  ###  ###
  19.  
  20.           *   * ### ###  ### ### ###  ###  ##  ### ###  ##  #  #
  21.           *   * #   #  #  #  #    #  #    #  #  #   #  #  # ## #
  22.            * *  ##  ###   #  ##   #  #    ####  #   #  #  # # ##
  23.             *   ### #  # ### #   ###  ### #  #  #  ###  ##  #  #
  24.  
  25.                 **  #    ##   ##  ###  ### ### #  # #     #
  26.                *  * #   #    #  # #  #  #   #  #  # ##   ##
  27.                **** #   # ## #  # ###   #   #  #### # # # #
  28.                *  * ###  ##   ##  #  # ###  #  #  # #  #  #
  29.  
  30.                  Configuration utility for AVA and AVA SF
  31.                                       
  32.  
  33.                        This program is supported by:
  34.                                 Cat Miller
  35.                            The Alternate Choice
  36.                               (602) 951-8534
  37.                                  1:114/39
  38.  
  39.  
  40.              Documentation by Cat Miller and Geoffrey Booher
  41.  
  42.  
  43.  
  44. PREFACE
  45. -------
  46.  
  47. Disclaimer
  48. ----------
  49.  
  50. AVACFG is provided as is, without warranty of any kind, either expressed
  51. or implied.  In no way, shall Cat Miller be held liable for any damages
  52. by use or misuse of the forementioned program.  Your use of this program
  53. implies your acceptance of these terms.  You will bear total
  54. responsibility.
  55.  
  56.  
  57.  
  58.  
  59. Introduction
  60. ------------
  61.  
  62.  
  63. This configuration utility serves two purposes.  It will create the
  64. necessary configuration file used by AVA and register your copy of AVA.
  65. Register.Ava and enter the registration number sent to you.
  66.  
  67. AVACFG was written using QuickBasic 4.5.  It is necessary to have the
  68. external run time library BRUN45.EXE somewhere in your DOS path.
  69.  
  70.  
  71.  
  72.  
  73. Using AvaCfg
  74. ------------
  75.  
  76.  
  77. AVACFG uses an optional command line parameter.  The command line
  78. parameter is the path to your AVA directory.  If no path is specified
  79. AVACFG will default to the current directory.  If Ava.Exe is not found in
  80. the path specified or in the current directory, AVACFG will return to DOS.
  81.  
  82. If this is a first time installation Avacfg.Exe will use a default set
  83. of parameters.  You can edit the default settings to your suit your
  84. particular needs.
  85.  
  86. Use your cursor keys to move the cursor to the menu option and press
  87. [Enter] to select that option.  The [Esc] key will back out and abort any
  88. function.
  89.  
  90. When editing, the Up/Down cursor keys will move you from field to field.
  91. To change a field just type in the new value.  Press [Enter] or move out
  92. of that field with your Up/Down cursor keys when you are done.  The toggle
  93. fields will be so marked.  Pressing any key in these fields will toggle
  94. the value.  Press [Enter] or move out of that field with your Up/Down
  95. cursor keys when you are done.
  96.  
  97.  
  98.  
  99.  
  100. Configuration file entries
  101. --------------------------
  102.  
  103.  
  104. 1> BBS Name
  105.    --------
  106.  
  107. Enter your BBS name here.
  108.  
  109.  
  110. 2> LD or Toll calling
  111.    ------------------
  112.  
  113. Toggle yes to this question if you want to call long distance or toll phone
  114. numbers.  If you plan to support calling Long Distance or Toll phone
  115. numbers for verification only, then you must toggle Yes to this field.
  116. A toll call is defined as a call within your areacode with which an
  117. additional rate is charged.
  118.  
  119. 3> Grant minimum access
  120.    --------------------
  121.  
  122. If you answered No to field #2 then you might want to consider granting
  123. a minimum access level to callers who meet this criteria.  Granting minimum
  124. access will give the caller the chance to look around your board until you
  125. get around to upgrading their status.
  126.  
  127. A No in this field will disable this feature and the caller will not be
  128. able to use AVA.
  129.  
  130.  
  131. 4> Verified security level
  132.    -----------------------
  133.  
  134. Enter the security level granted to callers who pass verification.  Be sure
  135. that this security level is defined in Limits.Ctl.
  136.  
  137.  
  138.  
  139.  
  140. Configuration File Entries
  141. --------------------------
  142.  
  143.  
  144. 5> Verified download byte limit
  145.    ----------------------------
  146.  
  147. Enter the daily download byte limit associated with field #4.  Download
  148. bytes are counted in kilobytes. NOTE: Not supported by SpitFire
  149.  
  150.  
  151. 6> Verified daily time limit
  152.    -------------------------
  153.  
  154. Enter the daily time limit associated with this level.
  155.  
  156.  
  157. 7> Minimum access security level
  158.    -----------------------------
  159.  
  160. This is the access level granted to callers if you answered Yes to option #3.
  161. Be sure that this level is defined in your Limits.Ctl file for QuickBBS,
  162. RemoteAccess or SuperBBS systems.
  163.  
  164.  
  165. 8> Minimum access download byte count
  166.    ----------------------------------
  167.  
  168. Enter the daily download byte limit allowed.  Be sure that this matches
  169. that which is defined in your Limits.Ctl file.  NOTE: Not supported for
  170. SpitFire.
  171.  
  172.  
  173. 9> Minimum access daily time limit
  174.    -------------------------------
  175.  
  176. Enter the daily time limit, in minutes, allowed for this level.  Be sure
  177. that this matches that which is defined in your Limits.Ctl file.
  178.  
  179.  
  180.  
  181.  
  182. Configuration File Entries
  183. --------------------------
  184.  
  185.  
  186. 10> Area Code
  187.     ---------
  188.  
  189. Enter your area code here.  This is used to check against phone numbers
  190. entered by callers.  It also plays a part in reformatting RemoteAccess
  191. free-style phone number format.  If you wish not to use PhoneNum.Ava to
  192. check for valid numbers, your area code is an important part in determining
  193. the kind of calls AVA will or will not place.
  194.  
  195.  
  196. 11> Edit phone number
  197.     -----------------
  198.  
  199. Normally you wouldn't use this but, toggle Yes if you want to support this
  200. feature.  Numbers are always checked against AVA's data file and checked
  201. for invalid characters and invalid digit sequences.  Preferably, you would
  202. answer No to this feature.  However, after a caller edits his number it is
  203. written to AVA.Log along with the original number.
  204.  
  205.  
  206. 12> Allow duplicate phone numbers
  207.     -----------------------------
  208.  
  209. Toggle Yes if you would like to support this feature.  Answer No if you do
  210. not.
  211.  
  212.  
  213. 13> SysOp Security Level
  214.     --------------------
  215.  
  216. This is here so that you can test AVA from the local console or remote.  If
  217. you want to determine which configuration best suits your needs then this is
  218. a good way to find out.
  219.  
  220.  
  221.  
  222.  
  223. Configuration File Entries
  224. --------------------------
  225.  
  226.  
  227. 14> LD calls for verification only
  228.     ------------------------------
  229.  
  230. A No will disable this feature while a Yes input will enable this feature.
  231. With this feature enabled, AVA will call long distance numbers.  Once the
  232. caller is verified, AVA will terminate the connection after informing the
  233. caller of their verified status and to call back at their convenience.
  234.  
  235.  
  236. 15> Toll calls for verification only
  237.     --------------------------------
  238.  
  239. A No will disable this feature while a Yes input will enable this feature.
  240. With this feature enabled, AVA will call toll numbers.  Once the caller is
  241. verified, AVA will terminate the connection after informing the caller of
  242. their verified status and to call back at their convenience.
  243.  
  244.  
  245. 16> Long Distance or Toll calling time
  246.     ----------------------------------
  247.  
  248. If you do not wish to support calling Long Distance or Toll numbers during
  249. a specific time period, then enter 00:00 00:00 to the 'Enter STARTING and
  250. ENDING ...' question.  This will disable that function.
  251.  
  252.  
  253. 17> Modem initialization string
  254.     ---------------------------
  255.  
  256. Enter an ATS0=0 to turn off auto answer.  Since your modem is already 
  257. initialized, there is no reason to initialize it again.  Pressing enter and
  258. leaving this field blank, AVACFG will use the default ATS0=0X4. 
  259.  
  260. NOTE:  For the newer HST/V.32bis modems - you will want ATB1 in your
  261.        initialization string somewhere.  This is needed for a faster connect.
  262.  
  263.        Recommended HST/V.32bis/V.42bis entry: ATB1E0Q0V1X6
  264.  
  265.  
  266.  
  267.  
  268. Configuration File Entries
  269. --------------------------
  270.  
  271.  
  272. 18> Baud rate to open comport
  273.     -------------------------
  274.  
  275. Enter a 0 here if you want to initialize the comport to the caller's baud
  276. rate.  Otherwise toggle the baud rate you wish to use.
  277.  
  278. If you use a U.S. Robotics Courier HST modem, and are locking the port at
  279. 19200 or 38400 - toggle the baud rate to the locked speed of your FOSSIL
  280. or serial port.
  281.  
  282.  
  283. 19> Seconds to wait for connect
  284.     ---------------------------
  285.  
  286. Enter the seconds you want AVA to wait for a carrier from the remote site.
  287. The default is 30 seconds.
  288.  
  289.  
  290. 20> Handshake
  291.     ---------
  292.  
  293. This is the hardware handshake used between your computer and modem.  The
  294. acceptable inputs are:
  295.  
  296.                     0 = No handshake
  297.                     1 = XON/XOFF
  298.                     2 = CTS
  299.                     3 = BOTH XON/XOFF and CTS
  300.  
  301. The default is 0.
  302.  
  303. If you have a high-speed modem such as a U.S. Robotics Courier HST, and you
  304. are locking the serial port/FOSSIL driver at 19200 or 38400, and are using
  305. RTS/CTS flow control (&B1&H1&R2) be sure to use handshake option 2 - CTS.
  306.  
  307.  
  308.  
  309. Configuration File Entries
  310. --------------------------
  311.  
  312.  
  313. 21> Dial prefix
  314.     -----------
  315.  
  316. You can now define your dialing prefix.  You will have a choice between
  317. ATDT or ATDP.  The default is ATDT.
  318.  
  319.  
  320. 22> Verification ONLY
  321.     -----------------
  322.  
  323. This feature works similiarly to the LD or TOLL verify only option but this
  324. option applies to LOCAL calls.  This is for the SysOps who run their BBS'
  325. on measured telephone lines.
  326.  
  327.  
  328. 23> Minimum minutes
  329.     ---------------
  330.  
  331. This feature allows you to define the minimum amount of time necessary for
  332. AVA to perform the verification.  You can disable this feature by using a
  333. 0.
  334.  
  335.  
  336. 24> Use Phonenum.Ava
  337.     ----------------
  338.  
  339. Toggle Yes to this option if you want AVA to check for valid calling
  340. numbers in Phonenum.Ava.  If you answer No, AVA will use it's internal
  341. checking as before.  Please refer to option #25.
  342.  
  343.  
  344. 25> Grant minimum access if number not found in Phonenum.Ava
  345.     --------------------------------------------------------
  346.  
  347. Toggle Yes to this option if you wish to grant minimum access to callers
  348. whose numbers are not found Phonenum.Ava.  Please refer to option #24.
  349.  
  350.  
  351. Configuration File Entries
  352. --------------------------
  353. This section does not pertain to SpitFire systems.
  354.  
  355. FLAG A, B, C, D
  356. ---------------
  357.  
  358. AVA is also able to manipulate the FLAGS.  You must remember that each
  359. flag consists of 8 'slots' or bits.  Each slot must be filled with
  360. either an x or a - (hyphen).  If you are going to NULL or not use a flag
  361. then there must be 8 hyphens.
  362.  
  363. A blank or NULL flag looks like this:
  364.  
  365.                A FLAG:   --------
  366.  
  367. A FLAG with the first bit set will look like this:
  368.  
  369.                A FLAG:   X-------
  370.  
  371.  
  372. AVACFG will NOT catch and correct blank slots.  If you are using the
  373. FLAGS then you are already aquainted with them so nuff said.  However,
  374. if you are not and don't intend to use them, just press enter to these
  375. questions and AVACFG will default to a blank flag.  This is valid only
  376. for a new setup.
  377.  
  378. AVA now respects current flag settings and will not reset them.  However,
  379. if you have set a flag(s) specifically to allow access to AVA, then you
  380. must set this same flag(s) in AVACFG.  This is so AVA will reset this
  381. flag(s) if verification was successful or the caller is granted minimum
  382. access.  On an unsuccessful verification, AVA will NOT rest this flag(s).
  383.  
  384. As an example, you have set Flag A to allow new callers to use AVA:
  385.  
  386.                            Flag A:  X-------
  387.  
  388. You MUST set this same flag in AVACFG.  Upon a successful verification AVA
  389. will reset this flag.  Your Flag A will then look this:
  390.  
  391.                            Flag A:  --------
  392.  
  393. Verified callers will no longer be able to access AVA.
  394.  
  395.  
  396.  
  397. Configuration File Entries
  398. --------------------------
  399.  
  400. 30> Use Direct screen writes
  401.     ------------------------
  402.  
  403. Toggle this option to allow direct screen writes.  AVA defaults to No,
  404. where it will use dos for screen writes.
  405.  
  406.  
  407.  
  408.  
  409. Support
  410. -------
  411.  
  412. Updates and or new releases of AVA can be downloaded or file requested
  413. from the support board, The Alternate Choice, 114/39, (602)951-8534,
  414. 300/1200/2400.  The magic filename is, AVA.
  415.  
  416. If you are installing AVA for the first time I will offer assistance.
  417. You may leave your questions, comments and suggestions to Cat Miller if I
  418. am not available for chat.
  419.  
  420. If you do send netmail, you can start polling for a reply within 48 hours.
  421.  
  422. Registered SysOps will have access to the OTW Support message base and
  423. should leave their messages there.  You may also contact one of the
  424. following Support Systems for assistance.
  425.  
  426. * AVA Distribution/Support System *
  427.  
  428. SysOp:      Geoffrey Booher
  429. BBS:        The Gateway Net BBS - a FrontDoor/RemoteAccess System
  430.             14.4 HST / 14.4 V.32bis / 9600 V.32 / V.42bis 20 hrs
  431. FidoNet:    1:11/233
  432. Number:     (815)233-5008  Freeport, IL - USA
  433. Comments:   FREQ magicname: AVA for the latest version
  434.             AVA QuickBBS, RemoteAccess, SuperBBS support USA
  435.  
  436.  
  437. * AVA SF Distribution/Support System *
  438.  
  439. SysOp:      Russell Mikami
  440. BBS:        The Hawaiian Hawke BBS - A SpitFire System
  441.             9600 V.32 / 14.4 HST 24 hrs
  442. FidoNet:    1:114/67
  443. Number:     (602)272-4887  Phoenix, AZ - USA
  444. Comments:   Netmail - SpitFire support
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Gratitude
  451. ---------
  452.  
  453.  
  454. Geoffrey Booher for his comments and suggestions for version 1.0 and
  455. later.
  456.  
  457. To the many others who took the time to send me your critisisms,
  458. suggestions and comments.
  459.  
  460. Thank you to the beta team, with whose help and support provides
  461. for a good, clean running program.
  462.  
  463. My sincere gratitude to all who have registered!
  464.  
  465.  
  466. Acknowledgements
  467. ----------------
  468.  
  469.     QuickBasic 4.5 is a product of MicroSoft.
  470.     Courier HST is a product of U.S. Robotics, Inc.
  471.     RemoteAccess is a product of Continental Software.
  472.     QuickC com library used with AVA is written and developed by Jeff
  473.     Sumberg.  He has developed an excellent library and can be found on
  474.     most BBS's as QBSERxx.Zip.
  475.  
  476.  
  477.  
  478.  
  479.     APPENDIX A
  480.     ----------
  481.  
  482.     AVACFG 4.0: Released with AVA v4.0.  Feb. 1991
  483.                 Previous versions are not compatible
  484.  
  485.     AVACFG 3.7: Released February 1991.
  486.                 Previous versions are not compatible
  487.     AVACFG 3.06
  488.  
  489.     AVACFG 3.05: Released September 1990.
  490.  
  491.     AVACFG 3.01: Released August 1990.
  492.  
  493.     AVACFG 3.0ß: Released August 1990 with AVA v3.0ß.
  494.                  Previous versions are not compatible
  495.  
  496.     AVACFG 2.3: Released March 1990.  Previous versions of AVACFG are not
  497.                 compatible.  Released with AVA 2.3.
  498.  
  499.     AVACFG 2.0: Released December 1989.  Previous versions of AVACFG are
  500.                 incompatible.  This is released with AVA 2.0.
  501.  
  502.     AVACFG 1.1: has been upgraded to suit AVA11f.  Support includes
  503.                 defining your modem init string and baud rate to open the
  504.                 comport.  The latter should be set to your modem's highest
  505.                 baud rate, irregardless of what the caller's baud rate is.
  506.  
  507.     AVACFG 1.1: was distributed with AVA 1.1d BETA. Previous versions of
  508.                 AVA are not compatible.
  509.  
  510.     AVACFG 1.0: was distributed with AVA 1.1 BETA.
  511.  
  512.     Initial release: May 1989
  513.  
  514.